package com.example.exceldemo.service;

import org.json.JSONObject;

/**
 * API服务接口
 * 处理与外部API的交互
 */
public interface ApiService {
    
    /**
     * 同步调用外部API
     * 
     * @param requestBody API请求体
     * @return API响应数据
     * @throws Exception 如果请求失败
     */
    String callApi(JSONObject requestBody) throws Exception;
    
    /**
     * 异步调用外部API
     * 
     * @param requestBody API请求体
     * @param metadata 任务元数据
     * @return 任务ID
     */
    String callApiAsync(JSONObject requestBody, String metadata);
} 